From a6a036ce22c2fa21b47a405e625360c02a140c91 Mon Sep 17 00:00:00 2001
From: Tristan Van Berkom <tristan.van.berkom@gmail.com>
Date: Fri, 10 Sep 2010 03:22:20 +0900
Subject: [PATCH] Adding note to docs of gtk_widget_set_window()

gtk_widget_set_window() does not add a reference to the
owned window... this is an exception to most gtk_foo_set_bar()
functions where as it acts as if it were named gtk_widget_take_window().

Adding note to the docs to avoid people giving the window to the
widget and naturally proceeding to unref the window.
---
 gtk/gtkwidget.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 2a1c980024..d749118059 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -11616,6 +11616,8 @@ gtk_widget_get_requisition (GtkWidget      *widget,
  * by calling gtk_widget_set_has_window(). This is usually done in the
  * widget's init() function.
  *
+ * <note><para>This function does not add any reference to @window.</para></note>
+ *
  * Since: 2.18
  */
 void
-- 
2.30.2